home *** CD-ROM | disk | FTP | other *** search
/ MacHack 1996 / MacHack 1996.toast / Hacks / Hacks ’88 / ∑Edit 1.12 ƒ / ∑Edit Docs.txt < prev    next >
Text File  |  1988-06-06  |  11KB  |  184 lines
  1.                         ∑Edit 1.11
  2.             Written by Leonard Rosenthol
  3.          Copyright ©1987 by LazerWare, inc.
  4.             
  5. Introduction and History
  6. ----------------------
  7.     As a programmer and avid telecommunicator, the DA that I used most of all was a
  8. text editing DA.  I chose the editor that I did because of its very nice interface and many useful 
  9. features, however it was far from being the ultimate DA text editor.  
  10.     So I waited and waited, hoping that something new and wonderful would come 
  11. along that would answer all of my wishes.  Well, nothing came along that answered
  12. all of my wishes.  I'd find one that handled tabs properly, but it wouldn't allow
  13. me to set the Font/Size I wanted to view the text in, or maybe I'd find one that 
  14. allowed unlimited length files, but didn't support Find/Replace.
  15.     Then recently I was hired as a contract programmer to do some work for a 
  16. professor here on campus in converting an IBM program onto the Macintosh.  The 
  17. only problem was that the program was in C, and I hadn't worked with C for a few 
  18. years and was not a big fan of using C on the Macintosh.  Well, I said, he's 
  19. paying me well, so I guess I better relearn my C.  ∑Edit is the product of my 
  20. adventures of relearning C, and using it on the Macintosh.
  21.     The first version of ∑Edit was put together in the period of about a week 
  22. (during which I got little sleep) using LightSpeed C, and Think's (or is it 
  23. Symantec's) CAPPS' package.  Therefore portions of this DA are copyright©1987 
  24. Think Technologies.
  25.     I have tried to put into it every feature that I wanted in my ultimate text 
  26. editing DA, and that other people have asked for. If I forgot something that you 
  27. would like to see in the next version of ∑Edit, please drop me a note either 
  28. electronically or by USnail.
  29.  
  30.     Leonard Rosenthol        GEnie: MACgician
  31.     205 E. Healey #33        Delphi: MACgician
  32.     Champaign, Il 61820        Bitnet: 3FLOSDQ@UIUCNOSA
  33.     Tele #: (217) 352-7435    Usenet: leonardr@uiucuxe.cso.uiuc.edu
  34.  
  35. Basic Features List
  36. ------------------
  37.     • File I/O (New, Open, Save, Save As, Revert)
  38.     • Printing to ANY printer
  39.         NOT limited to just the ImageWriter and LaserWriter
  40.     • Complete Cut/Copy/Paste support
  41.         TEXT ONLY!
  42.     • Ability to set the Font and Size to display the text in
  43.     • A movable, resizable and zoomable window
  44.     • Support for the arrow keys on the Mac+ and MacSE/Mac II keyboards for 
  45.     cursor movement
  46.  
  47. Additional Features
  48. ------------------
  49.     • Support for unlimited length files
  50.         Limited only by memory!!
  51.     • True Tabs with a user-definable setting
  52.     • Complete UNDO support for all functions that modify the text
  53.     • Very fast Search and Replace routines incl:
  54.         Replace
  55.         Replace All
  56.         Enter Selection into Find Dialog    (Command-E)
  57.     • AutoIndenting
  58.     • Ability to immediately jump to:
  59.         Beginning of current line    (Option-LeftArrow)
  60.         End of current line            (Option-RightArrow)
  61.         Beginning of document        (Command-,  or Command-< or Option-UpArrow)
  62.         End of document                (Command-.  or Command-> or Option-DownArrow)
  63.         Any line by number            (Command-/  or Command-?)
  64.     • Ability to shift paragraphs
  65.         Left by tab stops            (Command-[  or Command-{)
  66.         Right by tab stops            (Command-] or Command-})
  67.     • Triple clicking on a line will select that whole line
  68.     • Command or  Shift-ArrowKeys can be used to extend/shrink the selection range
  69.         Extend one character to right    Command/Shift-RightArrow
  70.         Extend one character to left    Command/Shift-LeftArrow
  71.         Extend one line down            Command/Shift-DownArrow
  72.         Extend one line up                Command/Shift-UpArrow
  73. (Added in 1.1)
  74.     • Information about your document can be obtained by doing a Command-I (for 
  75.     Information).  This will give you a character, word and line count.
  76.     • Command or Shift-Arrow keys now work exactly as described in Inside 
  77.     Macintosh IV (pgs. 3 - 6).  This is a change from the way they work in 1.0. 
  78.     You now have the ability to choose whether you want to use the Command or 
  79.     Shift key to signify selection!! (See Power User features for more 
  80.     information about this feature!)
  81.     • Command-Option or Shift-Option-Arrows work exactly as described in 
  82.     Inside    Macintosh IV (pgs. 3 - 6).  
  83.         Extend Selection to beginning of line        Command/Shift-Option-LeftArrow
  84.         Extend Selection to end of line                Command/Shift-Option-RightArrow
  85.         Extend Selection to beginning of document    Command/Shift-Option-UpArrow
  86.         Extend Selection to end of document            Command/Shift-Option-DownArrow
  87.     • You can now enter any ASCII character by doing a Command-` or Command-~.  
  88.     This will bring up a dialog with a list of all of the ASCII characters, in 
  89.     order, along with their hexadecimal and decimal values. Just select the 
  90.     character you want from the list, and it will be entered into the text at 
  91.     the current selection point.  Just in case you don't happen to catch this, 
  92.     the list is displayed in the current font and current size, and this may 
  93.     cause some problems (see Known Bugs below).
  94.     • Printing can be cancelled at any time by doing a Command-.  The dialog 
  95.     that is displayed during printing informs you of this, but I thought I'd 
  96.     add it in here.
  97.     
  98. All this comes in a DA that is ONLY 51K large!! and can be had for the small
  99. price of $0.00!   I am not asking  any money for this DA, since I did not intend 
  100. to sell it when I first staring writing it.  All that I ask is that you enjoy 
  101. using ∑Edit, that you pass it on to as many people as you can, and that if you 
  102. have a couple of bucks to spare that you might consider sending them to me.  
  103. ∑Edit may not be distributed with a product that is being sold for profit, 
  104. however if you wish to do so, please contact me and we can arrange something.
  105.  
  106. PowerUser Feature Notes
  107. ------------------------
  108.     •  All of the  default settings for ∑Edit  are stored in the DA's resource file under type DDAT.
  109.     There is a TMPL resource in the DA as well.  If you copy this TMPL into your copy of ResEdit, you will
  110.     find editing the default resource infinitly easier.
  111.     •  When doing a Find or Find/Replace you can enter some non-typeable keys into the Find/Replace
  112.     dialog by using the CommandKey in conjuction with the key.  In the present version, the following key
  113.     are supported:
  114.         Tab                Command-Tab
  115.         Carriage Return (CR)        Command-Return
  116.         NewLine/LineFeed (LF)        Command-Enter
  117.     • If you wish to search for a particular piece of text very quickly.  Select the text, do a 
  118.     Command-E (which enters the selection as the search text), and then do a Command-G 
  119.     (Find Again).  The next occurance of the previously selected text, will now be selected.
  120. (Added in 1.1)
  121.     • Some of you may have discovered this, but it really is undocumented.  If you do a Command-Q,  
  122.     it will have the    same effect as clicking in the close box (ie. Command-Q = Quit)
  123.     • If you are writing code, for example, and you have finished an indented section, and now wish to
  124.     go back a tab space, you previously had to type return and then hit backspace, you can now do an
  125.     Option-Return to have this done automatically.  You can also temporarily overide autoindenting 
  126.     (ie. bring the cursor back to the beginning of the next line) by doing a Shift-Option Return.
  127.     • Another user definable option has been added to the DDAT resource.  You can now set a Boolean
  128.     value that lets ∑Edit know whether you want to start up with an empty document, or with the
  129.     standard file dialog (SFGetFile).    
  130.     • Another new option in the DDAT allows you to tell ∑Edit whether you wish to use Command-Arrows
  131.     or Shift-Arrows for selecting text.  This was added to satisfy both  parties in the previous debate.
  132.     There is, however, a  problem.  Mac Plus owners (or those using a Mac Plus keyboard), CAN NOT use the
  133.     Shift-Arrow keys (even if the bit is set), just yet.  I will have this fixed in version 1.2, or in an intermediate version. 
  134.     • The other option that was added into the DDAT is a field that allows you to tell ∑Edit what creator
  135.     type you want any files saved by ∑Edit to use.  This way you can have ∑Edit create text files which can
  136.     later be opened with MacWrite, or QUED, etc. just by double clicking.
  137.     • You can now enter replacement text, using Command-W (or Command-w), in addition to being able to 
  138.     enter the search text.  This was added as a solution to the existing bug concerning pasting into the Find/Replace
  139.     Dialog.
  140.     • I remembered to include the TMPL in the DA so that you can make these changes!!
  141. (Added in 1.2)
  142.     • Yes, Galen, there is now Turbo Scrolling!!  What this means is that if you hold down the Command
  143.     key while clicking in either the up/down arrows or in the page up/down areas, you will scroll twice
  144.     as fast.  This is the way that FullWrite Professional implements its "Turbo Scrolling", and I liked it
  145.     so I implemented it this way.
  146.          
  147. Known Bugs or Problems
  148. ----------------------
  149.     I must admit that I have not throughly tested this DA in all possible combinations of hardware and
  150. software, but there is no reason why it should not work in just about any setting.  If you do find a situation
  151. where ∑Edit does not work, please let me know so I can correct it.
  152.     Although not a bug, the text WILL NOT WRAP when you reach the right side of the window.  You 
  153. must either explicity enter a return (which I did for this document) or have your text go beyond the window. 
  154. This is result of the CAPPS' package, not my coding.  But I will see if anything can be done about this for 
  155. the next version.
  156. (Fixed in 1.1)
  157.     The About box bug reported in version 1.0 has been fixed and you can now choose About ∑Edit till
  158. the cows come home without your machine doing funny things to you.
  159.     A bug that no one else found, but that did exist, is that if you happend to have document that was
  160. created in a size that ∑Edit's Typestyle DLOG did not recognize, then you would end up in bombville.  I have
  161. corrected this problem by changing any non-standard font size to 9pt during the OpenFile process.  I know
  162. that this is a bad idea, but until I have some time to redo the Typestyle dialog, this is it!
  163.     I have fixed a bug in the printing routines which would cause it to bomb on a Mac ][, but not, for
  164. some interesting reason, on any other type of Mac.  Anyway, the bug has been fixed and (as listed above)
  165. you can do a Command-. to cancel printing.
  166.     The Enter Ascii function is only preliminary and has some known quirks to it.  I am working on
  167. improving it for version 1.2.  Right now I am planning on adding the ability to autoselect by keystroke (i.e. 
  168. you hit a key and it becomes selected in the list) and finding a better way of drawing the list (LDEF time).
  169. If you any other suggestions for improvements,  please let me know. 
  170.     As noted above in the Power User Features, users with the Mac Plus keyboard (I have one too, so believe
  171. me that I am working on it) can not use Shift-Arrow keys, even if the Shift-Arrow bit is set.  
  172. (fixed in 1.2)
  173.     I HAVE DEFINATELY FIXED THE ABOUT BOX BUG!!!!
  174.     I have fixed some minor memory management problems and you should now be able to use ∑Edit 
  175. in environments that it would have problems with the stuff that it left behind before.
  176.  
  177.  
  178.     I am very open to suggestions and comments on ∑Edit.  If you have comments, questions, problems,
  179. suggestions, flames, or whatever please feel free to contact me using ANY of the above methods.
  180.     I hope that you enjoy ∑Edit as much as I enjoyed writing it and relearning C.  
  181.  
  182.                     Leonard Rosenthol
  183.                     Halevai Software
  184.